home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / hd273.arc / HDTEST.DOC < prev    next >
Encoding:
Text File  |  1986-11-10  |  48.0 KB  |  990 lines

  1.           
  2.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  3.           
  4.           
  5.                                   USER-SUPPORTED SOFTWARE                                  _______________________
  6.           
  7.           Much of the software which is available for your computer is produced
  8.           and sold on the assumption that you are a crook, who will take any
  9.           available opportunity to cheat its creators and vendors out of their
  10.           rightful reward. It is copy-protected within an inch of its (and your
  11.           computer's) life and is still priced at a level which guarantees its
  12.           producers a profit even if four or five illegal copies are made for
  13.           each one sold. User-supported software is different. You may have got
  14.           a copy of this package free from a friend or a bulletin board or (for
  15.           a nominal fee) from a users' group or software library. In any case,
  16.           you have a perfectly legal copy. You are encouraged to make as many
  17.           copies of the package as you like and to distribute them to all your
  18.           friends. If, after trying the program out, you find that it is useful
  19.           and want to keep it, you should register your copy by sending the
  20.           registration fee ($30.00,) together with the completed registration
  21.           form, to the address on the form. Only your conscience can make you do                                                                     ____       
  22.           this, but bear in mind that the distributors of "user-supported"
  23.           software make the assumption that you are honest and willing to pay a
  24.           reasonable price for a useful program, while many software vendors
  25.           would apparently rather believe you are a crook, and decide who you
  26.           would rather prove right. As a bonus, registered users will get a copy
  27.           of V3.10 of HDTEST, which includes a number of significant
  28.           enhancements over V2.73, and will be entitled to support and help with
  29.           HDTEST-related problems (including telephone support) for a year from
  30.           the date of registration.
  31.           
  32.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  33.           
  34.           
  35.           
  36.                                        INTRODUCTION                                       ____________
  37.           
  38.           HDTEST was written to allow comprehensive Read/Write testing of hard
  39.           disks on IBM PCs, XTs, ATs, and "true" compatibles. Although many
  40.           programs, including IBM's diagnostics, allow "surface scanning" and
  41.           seek testing of hard disks, none that are available to the average
  42.           user test whether the whole disk can retain the data that is or will
  43.           be written to it. HDTEST's principal "claim to fame" is the ability
  44.           thoroughly to test the surface of a hard disk which contains data
  45.           while preserving the data (although data loss is unavoidable if a          _________________________                                        
  46.           cluster which is in use has become unreadable).  HDTEST tests the disk                                               ____                             
  47.           much more thoroughly than programs such as DFixer, Mace, and Norton's
  48.           DT. Mace and DT, like many public domain "disk test" programs, simply
  49.           read every cluster on the disk and report on any errors encountered.
  50.           DFixer does better, writing 4 test patterns to every free cluster and
  51.           checking that they can be read back correctly, but it makes no attempt
  52.           to test clusters that are already in use - the very ones which contain
  53.           your precious data!
  54.           
  55.           HDTEST writes 20 different test patterns to every cluster on the disk                                                      _____                    
  56.           and checks that each pattern can be read back correctly, while
  57.           preserving the contents of the clusters that already contain data.
  58.           HDTEST can also (on most systems) detect errors which are minor enough
  59.           to be correctable (and corrected) by the disk controller's own "error-
  60.           correcting code" (ECC).  These errors are normally totally invisible
  61.           to programs running under DOS and will not usually be picked up by
  62.           other disk test utilities.  They may, however, be early signs of a
  63.           problem that will become significant later, and HDTEST consequently
  64.           marks the offending cluster as bad. As long as HDTEST can read the
  65.           data from a flaky cluster correctly once (and it tries quite hard) it
  66.           will be able to save the file of which that cluster is a part intact,                                                                        ______ 
  67.           while marking the cluster so that DOS does not try to use it again.
  68.           The program was designed to minimize the likelihood of user error
  69.           causing data loss on a good (or slightly bad) disk, and to be easy to
  70.           use - it could not be designed to be fast, since multiple bit patterns
  71.           have to be written to and read from each cluster, and this takes time.
  72.           The program can be used to test single and double-sided 8- and 9-
  73.           sector floppy disks (if you have plenty of patience!), but not (at                                           ______                    ___    
  74.           present) AT-format 1.2Mb floppies.
  75.           
  76.           HDTEST's companion program, HDCHEK, simply examines the logical
  77.           structure of the device and reports on what it finds. It does not
  78.           write to the disk, and is provided principally to allow a quick and
  79.           easy, but fairly reliable, check on the compatibility between HDTEST
  80.           and a given software/hardware configuration. In general, if HDCHEK                                                       ___________          
  81.           runs successfully on a system, then HDTEST can be expected to do so,
  82.           although the latter program does require more memory.
  83.           
  84.           The HDTEST package is distributed as "User-supported Software". If you
  85.           find it useful, you are asked to become a registered user by sending a
  86.           completed copy of the Registration Form (which is included in this
  87.           documentation), together with a check or money order for $30.00
  88.           ($40.00 Canadian, $25.00 Sterling) to me at the address which appears
  89.           on the form (and on the program's copyright screen). I will send you a
  90.           personalised copy of the latest, considerably enhanced, version of the
  91.           HDTEST package (V3.10), and register you for a year's support.
  92.           
  93.           
  94.                                           Page 2
  95.           
  96.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  97.           
  98.           
  99.           Registration entitles you to be notified of upgrades, bug fixes, newly
  100.           discovered incompatibilities, etc., and to ask for (and get) necessary
  101.           help in adapting the program to work on your hardware. I cannot guar-
  102.           antee to make HDTEST work with every possible combination of hardware
  103.           and software, but I will promise to try to solve problems as they come
  104.           up, and I will return your registration fee if I cannot support your
  105.           system.  Support will be available TO REGISTERED USERS ONLY by mail,                                             ________________________         
  106.           BIXmail, Compuserve EMail and, for an experimental period, telephone.
  107.           Please also bear in mind that my willingness and ability to continue
  108.           to support and enhance these programs will be directly dependent on
  109.           your willingness to pay the registration fee and (to some extent)
  110.           inversely dependent on the number of questions I get that could be
  111.           answered by reading the documentation(!).
  112.           
  113.           The HD programs were written principally in C, compiled by the
  114.           Microsoft C compiler (Version 4.00) using its "small" memory model,
  115.           and linked with code from the distributed Microsoft C object libraries
  116.           using the Microsoft LINK program (Version 3.51).  Additional assembly
  117.           language routines were assembled by the Microsoft MASM Macro Assembler
  118.           (Version 4.00). Portions of the distributed program are consequently
  119.           Copyright (C) by Microsoft Corp., 1985, 1986. All rights reserved.
  120.           These portions are used under the terms of a license from Microsoft
  121.           Corp.
  122.           
  123.           The HD programs were written with care and have been extensively
  124.           tested on a number of different systems.  I cannot, however, give any
  125.           guarantee as to their performance on a specific system, nor can I
  126.           accept liability for any actual or consequential loss resulting from
  127.           their use.  The programs may only be used and/or copied in their
  128.           original form. Unauthorised modifications and/or the use of all or
  129.           part of the programs in other software, commercial or otherwise, are
  130.           strictly prohibited.
  131.           
  132.           
  133.                                       GETTING STARTED                                      _______________
  134.           
  135.           This section gives step by step instructions for running HDCHEK and
  136.           HDTEST on the C: drive of a standard IBM PC, XT, or 100% compatible.
  137.           The following sections go into much more detail about some of the
  138.           program's features and options, and should help to explain and let you
  139.           deal with any problems which you may encounter.
  140.           
  141.           1) If you obtained a copy of the HDTEST package on a floppy disk, use
  142.           the DISKCOPY program to make a duplicate of it, put the original away
  143.           in a safe place, and use the duplicate as your working disk. If you
  144.           downloaded the package to your hard disk, make sure that you have a
  145.           backup copy on floppy disk or tape before proceeeding.
  146.           
  147.           2) Make sure that you have current backups of all the files on the
  148.           disk on which you plan to run HDTEST. This is particularly important
  149.           when running the program for the first time on a new system.
  150.           
  151.           3) Run DOS's CHKDSK program on drive C: and correct any errors
  152.           reported by it before proceeding further.
  153.           
  154.           4) Make the drive and/or directory which contains HDCHEK.EXE and
  155.           HDTEST.EXE your current drive and/or directory.
  156.           
  157.           
  158.                                           Page 3
  159.           
  160.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  161.           
  162.           
  163.           
  164.           5) Insert a formatted, non-write-protected floppy disk in drive A. A
  165.           log file called HDTEST.LOG will be written to this disk - any other
  166.           files on it will be undisturbed.
  167.           
  168.           6) Give the command: "HDCHEK C:". After a certain amount of disk
  169.           activity has taken place, and certainly within a minute or two, your
  170.           screen should look like one of the examples given in the Appendix. If
  171.           any errors are reported, DO NOT PROCEED until you have read the rest                                   ______________                             
  172.           of the documentation and/or are sure you know what is going on.
  173.           
  174.           7) If HDCHEK reported no errors, give the command "HDTEST C: A:".             ____________________________                                  
  175.           After some disk activity, the program will prompt for replies to three
  176.           questions - press <Return> in response to each prompt. The program
  177.           will report its progress to the screen and will record any problems
  178.           encountered in the log file on the floppy disk. Depending on the size
  179.           of your DOS partition and the access time of the disk, a complete run
  180.           of HDTEST will take between 2 and 5 hours. Your intervention will only                                              _____                             
  181.           be required if a bad cluster is found in a "hidden", "system", or
  182.           write-protected file, when you will be asked to approve remapping;
  183.           otherwise, bad clusters will be automatically remapped. HDTEST can be
  184.           aborted at any time by pressing <Esc> and responding to the "Are you
  185.           sure...." prompt by pressing <Return>.
  186.           
  187.           8) If HDTEST finishes testing without finding any bad clusters, it
  188.           will simply record that fact and the finishing time in the log file
  189.           and return to the DOS prompt. Otherwise, when read/write testing has
  190.           been completed, you will be prompted for permission to complete the
  191.           remapping process by updating the disk FATs and Directories.  Pressing
  192.           <Return> will allow this to take place, and you will then be returned
  193.           to the DOS prompt.
  194.           
  195.           9) If HDTEST reported and remapped some bad clusters, see the section
  196.           on "Dealing with bad clusters" later in this documentation.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.           
  221.           
  222.                                           Page 4
  223.           
  224.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  225.           
  226.           
  227.            
  228.                              HARDWARE & SOFTWARE REQUIREMENTS                             ________________________________
  229.           
  230.           HDTEST and HDCHEK make a number of assumptions about the environment
  231.           in which they are operating. They will, generally speaking, abort with
  232.           an informative error message if they find one of these assumptions to
  233.           be untrue! They require MS/PC-DOS 2.x or above and (for HDTEST) up to
  234.           about 256 Kb of free memory (the exact amount required depends on the
  235.           characteristics of the device being tested) to run - the presence of
  236.           more memory may (slightly) increase HDTEST's speed when testing
  237.           devices with large cluster sizes. The device to be tested must have
  238.           been initialized by FDISK and FORMATted by the DOS utility; only the
  239.           DOS partition of a multi-partition disk will be tested.  For this
  240.           reason, if you wish to test a new hard disk which is to contain                                 ____                                    
  241.           multiple partitions, you should first configure it as a single DOS
  242.           partition, test it in that configuration, and then reconfigure it to
  243.           its final form. Note that, under these circumstances, HDTEST can only
  244.           test the disk - its marking and/or remapping of bad sectors does not          ____                                                                
  245.           survive re-partitioning.  The BIOS handler for interrupt 13 must be
  246.           capable of handling (at least) normal disk reads and writes (sub-
  247.           functions 2 and 3) in a way that is compatible with that documented
  248.           for the XT disk adapter in IBM's technical documentation. This should
  249.           be no problem for most disk systems on IBM PCs and most compatibles.
  250.           HDTEST may not, however, be usable with non-bootable hard disks and/or                 ___                                                            
  251.           with hard disks which require special device drivers to be installed.
  252.           
  253.           If run under DOS 3.0 or above, HDTEST attempts to locate and use the
  254.           ROM BIOS INT 13 entry point, rather than the normal INT 13 vector
  255.           (which DOS 3.x intercepts and interferes with). For this purpose, the
  256.           program assumes that, if a ROM is present at absolute address C8000H,                                ___________________                            
  257.           it contains the hard disk BIOS and has initialization code starting at                                         ___                                    
  258.           offset 3. This assumption is true for all hard disks which "plug in"
  259.           to the IBM PC and XT. It may not be true for all clones which come
  260.           with hard disks installed, although it is likely to be true for most
  261.           of them. The AT and some of its clones have no ROM at all at this
  262.           location, which is OK, too (but see para 5 in the "Limitations and
  263.           Restrictions" section). Problems (up to and including system halts)
  264.           may occur if there is a ROM at C8000H but it does not control the hard                             __                             ___                 
  265.           disk, and are almost certain if the initialization code does not start
  266.           at offset 3. If you have any problems running HDCHEK and HDTEST on
  267.           such systems, try invoking the programs with the /D flag (see below).
  268.           
  269.           Note that, since HDTEST remaps bad clusters to free space, there is
  270.           not much point in running it on a disk which has none (as shown by
  271.           DIR or CHKDSK), since it will abort immediately if it finds a bad
  272.           cluster.  Unless you have a really flaky disk, however, you should not
  273.           need more than a couple of hundred Kb free to remap any reasonably
  274.           probable number of bad clusters.
  275.           
  276.           ANSI.SYS should be installed on those systems (including IBM PCs)
  277.           which do not support ANSI screen I/O in Video BIOS - nothing terrible
  278.           will happen if ANSI.SYS is not installed, but the screen display will
  279.           be very strange (!!). I will consider distributing a version which
  280.           uses the IBM Video BIOS as well if there seems to be a demand for it.
  281.  
  282.  
  283.  
  284.           
  285.           
  286.                                           Page 5
  287.           
  288.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  289.           
  290.           
  291.           
  292.                                LIMITATIONS AND RESTRICTIONS                               ____________________________
  293.           
  294.           The current version of HDTEST has a few limitations, most of which
  295.           result from the way data is stored internally by the program. None of
  296.           them are "etched in stone", although some could only be avoided at the
  297.           cost of slowing down what is already far from a fast process. The
  298.           known limitations are as follows:
  299.           
  300.           1) Maximum number of clusters per disk = 24,000 (this number is
  301.           approximate, because it depends on dynamic memory allocation). This
  302.           limit may be increased to 32,768 in a subsequent version of the
  303.           program.
  304.           
  305.           2) Maximum total number of directory and subdirectory entries (files
  306.           plus subdirectories) = 3,640. I expect this restriction to be removed
  307.           in a subsequent version of the program.
  308.           
  309.           3) Maximum cluster size = 65,535 bytes. I do not believe that a DOS
  310.           disk can ever have clusters larger than 64 Kb, but my limit is one
  311.           less than that and may, since sector and cluster sizes tend to run in
  312.           powers of 2, effectively limit cluster size to 32 Kb - this should be
  313.           enough for most people!.
  314.           
  315.           4) Because of certain limitations of the chips used to support direct
  316.           memory access (DMA, the method used to transfer data from disk to
  317.           memory and vice versa), HDTEST may be unable to use free memory
  318.           efficiently when cluster sizes are large. This can result in
  319.           "Insufficient Memory" or "Memory Allocation" errors, even on systems
  320.           with more than the minimum 256 Kb of free memory prescribed above. The
  321.           only cure for this is to free up (or buy!) more memory (remove
  322.           RAMdisks, remove resident software, etc.).
  323.           
  324.           5) This version of HDTEST will run on ATs and most AT clones, but will
  325.           not be able to detect corrected ECC errors when run on these machines
  326.           - a warning message will be displayed when the program initializes
  327.           itself if corrected ECC errors are not being detected.  The program
  328.           will also not detect corrected ECC errors when invoked with the /D
  329.           flag (under DOS 3.0 or above).
  330.           
  331.           
  332.                                    RUNNING THE PROGRAMS                                     ____________________  
  333.           
  334.           Always run HDCHEK on any new hardware/software configuration before
  335.           you attempt to run HDTEST (for the first time). The latter program has
  336.           been written as conservatively as possible, but it impossible to
  337.           predict the behavior of every conceivable combination of hardware and
  338.           operating system when dealing with a program which bypasses most of
  339.           the controls which normally protect the user from destroying his
  340.           world. HDCHEK is invoked with the command line:
  341.           
  342.                           HDCHEK device [/D]
  343.           
  344.           "device" is the device to be tested (e.g. A:, B:, etc. - the colons
  345.           are permitted but not required). The optional flag has no effect under                            ___                                                 
  346.           DOS 2.x.  Under DOS 3.0 or above, it forces HDCHEK to use the existing
  347.           INT 13 vector (which it always does under DOS 2.x), and prevents the
  348.           
  349.           
  350.                                           Page 6
  351.           
  352.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  353.           
  354.           
  355.           program from trying to determine the ROM BIOS entry point; the flag
  356.           should be used if you know that your system's fixed disk BIOS does not
  357.           follow IBM's "rules" or if the program crashes the system when invoked
  358.           without it.
  359.           
  360.           After a short delay, during most of which the specified device will be
  361.           active, a description of the device's logical structure will be
  362.           displayed.  After a further delay and more disk activity, a message
  363.           will be printed giving the number of files and subdirectories found on
  364.           the disk, and the program will exit back to DOS. Errors and problems,
  365.           if any, will be reported in some detail. A number of example screen
  366.           displays and log files produced by running HDCHEK and HDTEST on
  367.           different systems will be found in the Appendix at the end of this
  368.           documentation.
  369.           
  370.           Always run the DOS CHKDSK program immediately before running HDTEST on
  371.           a disk. If CHKDSK reports any problems, its /F option (or other means)
  372.           should be used to correct them before HDTEST is run.                                         ____________________ 
  373.           
  374.           HDTEST is invoked with the command line:
  375.           
  376.                      HDTEST device1 [device2] [/D] [/N] [/P] [/Snnnnn]
  377.           
  378.           "device1" is the device to be tested, as for HDCHEK. "device2" (which,
  379.           if present, must be different from "device1") is the name of a device
  380.           on which a log file (called HDTEST.LOG) is to be written. If "device2"
  381.           is not specified, errors are reported to the console terminal and                                                                        ___
  382.           should not be redirected.          ________________________ 
  383.           
  384.           The /D(OS) flag has the same meaning and effect that it does for
  385.           HDCHEK.
  386.           
  387.           The /P(rint) flag causes the log file to be directed to the PRN device
  388.           (normally LPT1), and overrides any "device2" specification.
  389.           
  390.           The /N(o Query) flag disables the individual prompts for confirmation
  391.           which the program normally issues before remapping clusters which are
  392.           marked as "Reserved" or which are part of a file which is marked as
  393.           "System", "Hidden", or "Readonly".  The /N flag does not prevent the                                                               ___            
  394.           program from prompting for confirmation before updating the disk.
  395.           
  396.           The /S(tart) flag causes HDTEST to start testing occupied clusters at                                                           ________            
  397.           cluster number nnnnn (expressed as a decimal number). There must be no
  398.           space between the "S" and the starting cluster number. This will
  399.           mainly be useful when a previous run of HDTEST had to be aborted, when
  400.           it allows you to start where you left off. Note that, in order to be
  401.           sure that data is not remapped to a bad area, HDTEST always tests all                                                                ______       ___ 
  402.           empty clusters before starting to test occupied clusters. For this
  403.           reason, using the /S flag will not result in a significant time saving
  404.           if your disk is nearly empty, and will make the most difference on a
  405.           full, or nearly full disk.
  406.           
  407.           After displaying its copyright message, HDTEST reads the FATs and
  408.           scans the root directory and all subdirectory trees of the specified
  409.           device before initiating a short dialogue. All questions are of the
  410.           "Yes/No" type and should be answered by typing "Y" or "N" (case does
  411.           not matter) and pressing the <Return> key.  Pressing the <Return> key
  412.           
  413.           
  414.                                           Page 7
  415.           
  416.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  417.           
  418.           
  419.           alone is equivalent to giving the default response (which appears in
  420.           square brackets at the end of each prompt).  HDTEST then proceeds to
  421.           test the specified device. By default, the DOS area (boot sector,
  422.           FATs, and root directory) is not routinely subjected to Read/Write
  423.           testing, since failures in this area usually make themselves apparent
  424.           fairly rapidly. The user can, however, choose to run the full tests on
  425.           the DOS area too, or to limit testing to read and seek tests only over
  426.           the whole partition.
  427.           
  428.           In testing a block (sector or cluster), HDTEST first reads it (retry-
  429.           ing, if necessary, up to five times) and then does the longest
  430.           possible seek away from it before attempting to read it again. The
  431.           program then sequentially writes 20 different bit patterns to the
  432.           block and checks that each one can be read correctly before rewriting
  433.           the original contents of the block (and checking once more to ensure
  434.           that it has been restored correctly). Errors that occur at any point
  435.           in this process are reported and (if the block is in the data area -
  436.           errors in the DOS area are always treated as fatal) the block is
  437.           remapped. If an error is detected in a "Reserved" cluster or in one
  438.           that is part of a file which is marked as "System", "Hidden", or
  439.           "Readonly", the user is normally asked for confirmation before the
  440.           cluster is remapped, otherwise it is assumed that remapping is
  441.           desirable.
  442.           
  443.           HDTEST keeps a copy of the FAT and a map of the device's directory
  444.           structure in memory. A bad cluster is remapped by transferring its
  445.           contents to a free cluster and changing all necessary FAT and
  446.           directory entries so that the pointer chain which maintains the
  447.           structure of the file of which the bad cluster formed a part remains
  448.           valid. The bad cluster's FAT entry is altered to mark it as bad. The
  449.           disk's FATs and directories are not altered until the whole disk has          ______                                                              
  450.           been scanned, and then only after the user has confirmed that it is OK
  451.           to proceed. This means that a power failure and/or an inadvertent
  452.           power-off which occurs while the program is running will cause the
  453.           loss of, at most, one cluster of data and (unless you are very unlucky                                                                    ____        
  454.           and it happens after you have confirmed that you want a damaged data
  455.           area to be remapped and while this is being done) of no FAT or root
  456.           directory information. If a power failure and/or power-off occurs
  457.           while a cluster which contains the directory information of a
  458.           subdirectory is being tested, part or all of that subdirectory will,
  459.           of course, become inaccessible through DOS, although the data in it
  460.           will remain on the disk and be potentially recoverable with the aid of
  461.           (e.g.) the Norton Utilities (TM). You can safely abort the testing
  462.           process part way through by pressing the <Esc> key, with no risk of
  463.           leaving a partially updated FAT or directory. If you do abort the
  464.           program in this way, you will be given the option of updating the
  465.           disk, so that bad clusters which were detected before <Esc> was
  466.           pressed can be remapped.
  467.           
  468.           Errors which occur in the program's initialization phase cause it to
  469.           abort with an error message and (sometimes) a hexadecimal error code.
  470.           The meaning of the error code is context-dependent. Errors detected
  471.           during read-write testing only cause the program to abort if they
  472.           occur during testing of the DOS area, or if remapping is impossible
  473.           (only likely to happen if the disk is full). In any event, a
  474.           description of the error is written to the log file (if any) or to the
  475.           screen. This specifies the cluster or (for the DOS area) sector
  476.           
  477.           
  478.                                           Page 8
  479.           
  480.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  481.           
  482.           
  483.           number and the name of the affected file (if any), and defines the
  484.           type of error wich occurred.
  485.           
  486.           HDTEST takes a very long time to run to completion because of the                         ____                                              
  487.           large number of reads and writes it does for each cluster. A typical
  488.           time for an XT disk (10 Mb) would be 2 hrs; full disk testing on a 30
  489.           Mb AT Plus takes at least 4 hrs.
  490.           
  491.           
  492.                                  DEALING WITH BAD CLUSTERS                                 _________________________
  493.           
  494.           It is, unfortunately, not unusual for a new hard disk to have a small,                                                                           ______ 
  495.           constant, number of bad clusters. IBM's quality control standards          ________                                                         
  496.           allow, for example, 5% of the surface area of a disk to be bad (!).
  497.           These bad clusters, which correspond to imperfections in the magnetic
  498.           coating on the disk, will normally be detected and marked by the DOS
  499.           FORMAT program and HDTEST will report them as "already marked as bad".
  500.           This should not be regarded as evidence of any real problem with the
  501.           disk, although some suppliers (not including IBM) will replace such                                         ___                                 
  502.           disks under warranty if pressed to do so.  It is also not unusual for
  503.           a disk to develop a few more defects as it ages. When these do                              ___                                       
  504.           develop, they are also usually constant in size and position, and will
  505.           be reported as "already marked as bad" by HDTEST on runs subsequent to
  506.           that during which they are first found. The occasional appearance (and                                                      __________                
  507.           subsequent persistence) of a new bad cluster is, therefore, not
  508.           necessarily evidence of serious trouble developing.  However, if more
  509.           than one or two new bad clusters are reported by HDTEST, and
  510.           especially if two consecutive runs of HDTEST report different bad                                                              _________    
  511.           clusters, there is a good chance that the hard disk or controller is
  512.           developing a serious problem - it should be backed up immediately and
  513.           sent for repair at the earliest opportunity.  New bad clusters in the
  514.           data area are automatically mapped out by HDTEST, and no further
  515.           action is necessary.  Bad sectors in the DOS area can only be handled
  516.           by backing up the disk (if this is still possible), reconfiguring it
  517.           with FDISK so that the DOS partition starts above the bad area, re-
  518.           FORMATting it, and restoring all of the old files to the new partition
  519.           (which will unavoidably be a little smaller than the old).  If
  520.           absolute sector zero (track 0, Head 0, sector 1) becomes bad, the disk
  521.           must be replaced.
  522.           
  523.           
  524.                             BUGS AND OTHER UNPLEASANT SUBJECTS                            __________________________________
  525.           
  526.           Although, like all programmers, I sometimes like to think that my
  527.           product is perfect, it is possible that there are a few bugs lurking
  528.           in the depths of the program, and likely that some combination of
  529.           software and hardware exists which HDTEST cannot figure out and/or
  530.           cope with. If you think you have found a bug and/or if you cannot get
  531.           either of the programs to work on your system, do the following:
  532.           
  533.           1) Reread this documentation! Make sure that you are doing exactly
  534.           what the documentation says to do. Make sure (if you are testing a
  535.           drive with removable media) that the media is not write-protected.
  536.           
  537.           2) Boot your system from a "virgin" DOS disk - preferably a copy of
  538.           your DOS distribution disk - and try again to run the HD programs. If
  539.           they run in this environment but not in your normal DOS environment,
  540.           
  541.           
  542.                                           Page 9
  543.           
  544.           Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher          ______________________________________________________________________
  545.           
  546.           
  547.           try reconstructing the system under which they failed by adding things
  548.           one by one until the problems recur and let me know about the
  549.           incompatibility.
  550.           
  551.           3) If the above approaches do not help, or if HDCHEK runs but HDTEST
  552.           bombs (the reverse should never happen), send me as detailed a
  553.           description of the problem as possible and (IF you are a registered                                                      _______________________
  554.           user) I will do my best to diagnose and fix it. A bug report should          ____                                                               
  555.           always include a full description of the system being used, as well as          ______                                                                
  556.           the output from a run of HDCHEK.
  557.                               CHANGES FROM PREVIOUS VERSIONS                              ______________________________
  558.           
  559.           The first version released (other than beta-test versions) was V2.60.
  560.           
  561.           
  562.           Version 2.73 (this version) -
  563.           
  564.           The following (visible) changes have been made in HDCHEK:
  565.           
  566.           1) Minor bug in V2.60 (which resulted in a failed directory scan if
  567.           HDCHEK was run on a write-protected floppy) fixed (at V2.71).
  568.           
  569.           
  570.           The following (visible) changes have been made in HDTEST:
  571.           
  572.           1) Bug in V2.60 (which could cause bad termination of the program and
  573.           possible subdirectory inconsistencies if a sector which was not in use
  574.           was found to be bad) fixed (at V2.70).
  575.           
  576.           2) Bug in V2.70 (which caused the program to enter a terminal input
  577.           loop if ANSI.SYS was not loaded and <Esc> was entered to abort it)
  578.           fixed (at V2.73).
  579.           
  580.           3) Internal changes made to avoid interference with expanded memory
  581.           device handlers (at V2.72).
  582.           
  583.           4) Ability to update disk after program terminated by user (typing
  584.           <Esc>) added (at V2.70).
  585.           
  586.           5) Ability to start checking occupied clusters at a given cluster
  587.           number added (at V2.70).
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.           
  605.           
  606.                                          Page 10
  607.      
  608.      Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher     ______________________________________________________________________
  609.      
  610.      
  611.  
  612.                       APPENDIX - EXAMPLE PROGRAM RUNS                      _______________________________
  613.  
  614.      Screen display from successful run of HDCHEK on 14 Mb DOS partition of
  615.      20 Mb hard disk:
  616.  
  617.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  618.              =================================================
  619.  
  620. This program is part of the HDTEST package, which is distributed as "User
  621. Supported Software". The package may be copied and distributed freely by
  622. individual users, provided that no charge is made for copying and/or supplying
  623. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  624. supplying a copy of the package on a floppy disk.
  625.  
  626. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  627. reserved. Used under Licence.
  628.  
  629. Device C: is the DOS partition of a hard disk.
  630. It contains 29104 sectors.
  631. Total partition size is approximately 14 Mb.
  632. It starts at absolute sector 8364 on the disk.
  633. There are 4 heads and 17 sectors/track.
  634. Sector size is 512 bytes.
  635. Each (12 bit) FAT occupies 11 sectors.
  636. The Root Directory occupies 32 sectors.
  637. The data area starts at DOS sector 55, and contains 3631 clusters, each
  638. consisting of 8 sectors.
  639. The directory scan was successful; a total of 1018 files and subdirectories
  640. was found.
  641.  
  642.  
  643.  
  644.      Screen display from successful run of HDCHEK on DSDD 9-sector floppy disk:
  645.  
  646.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  647.              =================================================
  648.  
  649. This program is part of the HDTEST package, which is distributed as "User
  650. Supported Software". The package may be copied and distributed freely by
  651. individual users, provided that no charge is made for copying and/or supplying
  652. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  653. supplying a copy of the package on a floppy disk.
  654.  
  655. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  656. reserved. Used under Licence.
  657.  
  658. Device A: is a floppy disk.
  659. The disk contains 720 sectors.
  660. There are 2 heads and 9 sectors/track.
  661. Sector size is 512 bytes.
  662. Each (12 bit) FAT occupies 3 sectors.
  663. The Root Directory occupies 7 sectors.
  664. The data area starts at DOS sector 12, and contains 354 clusters, each
  665. consisting of 2 sectors.
  666. The directory scan was successful; a total of 38 files and subdirectories
  667. was found.
  668.      
  669.      
  670.                                     Page 11
  671.      
  672.      Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher     ______________________________________________________________________
  673.      
  674.      
  675.  
  676.      Screen display from run of HDCHEK on 14 Mb DOS partition - directory
  677.      structure bad or unrecognizable:
  678.  
  679.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  680.              =================================================
  681.  
  682. This program is part of the HDTEST package, which is distributed as "User
  683. Supported Software". The package may be copied and distributed freely by
  684. individual users, provided that no charge is made for copying and/or supplying
  685. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  686. supplying a copy of the package on a floppy disk.
  687.  
  688. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  689. reserved. Used under Licence.
  690.  
  691. Device C: is the DOS partition of a hard disk.
  692. It contains 29104 sectors.
  693. Total partition size is approximately 14 Mb.
  694. It starts at absolute sector 8364 on the disk.
  695. There are 4 heads and 17 sectors/track.
  696. Sector size is 512 bytes.
  697. Each (12 bit) FAT occupies 11 sectors.
  698. The Root Directory occupies 32 sectors.
  699. The data area starts at DOS sector 55, and contains 3631 clusters, each
  700. consisting of 8 sectors.
  701. The preliminary directory scan failed.
  702.  
  703.  
  704.      Screen display from run of HDCHEK on 14 Mb DOS partition - FATs not
  705.      identical:
  706.  
  707.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  708.              =================================================
  709.  
  710. This program is part of the HDTEST package, which is distributed as "User
  711. Supported Software". The package may be copied and distributed freely by
  712. individual users, provided that no charge is made for copying and/or supplying
  713. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  714. supplying a copy of the package on a floppy disk.
  715.  
  716. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  717. reserved. Used under Licence.
  718.  
  719. FATS are different
  720. FAT discrepancy at byte 20F - FAT 1 has FF; FAT2 has F8
  721. Continue comparison (Y/N)? [Y]: n     {user input}                                _                 
  722.  
  723. Device C: is the DOS partition of a hard disk.
  724. It contains 29104 sectors.
  725. Total partition size is approximately 14 Mb.
  726. It starts at absolute sector 8364 on the disk.
  727. There are 4 heads and 17 sectors/track.
  728. Sector size is 512 bytes.
  729. Each (12 bit) FAT occupies 11 sectors.
  730. The Root Directory occupies 32 sectors.
  731. The data area starts at DOS sector 55, and contains 3631 clusters, each
  732.      
  733.      
  734.                                     Page 12
  735.      
  736.      Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher     ______________________________________________________________________
  737.      
  738.      
  739. consisting of 8 sectors.
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      
  797.      
  798.                                     Page 13
  799.      
  800.      Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher     ______________________________________________________________________
  801.      
  802.      
  803.  
  804.  
  805.      Screen display from run of HDCHEK - program unable to deduce disk
  806.      structure - disk not recognizable as a DOS device:
  807.  
  808.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  809.              =================================================
  810.  
  811. This program is part of the HDTEST package, which is distributed as "User
  812. Supported Software". The package may be copied and distributed freely by
  813. individual users, provided that no charge is made for copying and/or supplying
  814. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  815. supplying a copy of the package on a floppy disk.
  816.  
  817. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  818. reserved. Used under Licence.
  819.  
  820. Unrecognised media descriptor byte! - see error code
  821. Error Code = F1      {F1 is not a media descriptor byte used by DOS}
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.      
  861.      
  862.                                     Page 14
  863.      
  864.      Documentation for HDTEST V2.73          Copyright 1986, P. R. Fletcher     ______________________________________________________________________
  865.      
  866.      
  867.      
  868.      
  869.      Log file from successful run of HDTEST on 14 Mb DOS partition of 20 Mb hard
  870.      disk:
  871.      
  872.      HDTEST Log File - Tue Jul 08 11:44:52 1986
  873.      Testing Device C:
  874.      
  875.      No bad clusters found - HDTEST finished.
  876.      Tue Jul 08 14:10:41 1986
  877.      
  878.      
  879.      Log file from run of HDTEST on 14 Mb DOS partition - one bad cluster
  880.      detected and remapped:
  881.      
  882.      HDTEST Log File - Tue Jul 08 11:44:52 1986
  883.      Testing Device C:
  884.      
  885.      Read/Write error at cluster number 275!!
  886.      Uncorrected ECC error occurred during pattern read/writes
  887.      This error is recoverable (no data loss has occurred).
  888.      Bad cluster is in file \MYFILES\DATA5\FFT1234.DAT
  889.      
  890.      1 bad clusters found and remapped - HDTEST finished.
  891.      Tue Jul 08 14:01:04 1986
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.      
  925.      
  926.                                     Page 15
  927.      
  928.      
  929.                             REGISTRATION FORM - HDTEST V 2.73                            _________________________________
  930.      
  931.      Please complete this form and return it with a check or money order (no
  932.      cash, please) for $30.00 ($40.00 Canadian, $25.00 Sterling) to:
  933.      
  934.                      Peter R. Fletcher
  935.                      220 Ballard Drive
  936.                      West Hartford
  937.                      CT 06119
  938.                      U.S.A.
  939.      
  940.      None of the information on this form will be passed on to any other
  941.      individual or commercial organization. Use the back of the form for
  942.      comments or additional space.
  943.      
  944.      --------------------------------------------------------------------------
  945.      
  946.      This information is required to process your Registration:
  947.      
  948.      Last Name:____________________________  Other Names:______________________
  949.      
  950.      Address:______________________________  Town/City:________________________
  951.      
  952.      State:_____________  Post Code:____________  Telephone:_________________
  953.                                                            (evenings/weekends)
  954.      
  955.      I understand that this software is supplied without warranty, express or
  956.      implied, and agree not to hold its author liable for any direct or
  957.      consequential loss arising out of my use of it.
  958.      
  959.      Signature:______________________________
  960.      
  961.      -------------------------------------------------------------------------
  962.      
  963.      You are requested, but not required, also to answer the following
  964.      questions:
  965.      
  966.      On What type(s) of computer are you using HDTEST? _________________________
  967.      
  968.      CPU (8088, 8086, etc.)? __________   Amount of RAM (kB)? ____________
  969.      
  970.      Type & Size of Hard Disk(s)? ____________________________________
  971.      
  972.      Make and Type of Hard Disk Controller(s)? ______________________________
  973.      
  974.      Do you own a Modem?                                             Y  N
  975.      
  976.      Are you a member of BIX?   Y  N        Compuserve?              Y  N
  977.      
  978.      Do you own or have access to a Cauzin Softstrip Reader          Y  N
  979.      
  980.      Did you think that the $30.00 registration fee for this program was:
  981.      
  982.      Very Good Value?              About Right?             Excessively High?
  983.      
  984.      
  985.      Are there any other utility programs that you would like to see made
  986.      available as "User Supported Software"? What sort of programs?
  987.      
  988.      
  989.      
  990.